pp108 : Configuring Drill-down from Instance-Level Views

Configuring Drill-down from Instance-Level Views

This topic describes the procedure to configure drill-down from Instance-Level Views.

Note:

  • The TopXInstancesByLeadTimeForStatus_SpecificProcess composite control available at the location /Cordys/WCP/Controls/runtime/bam/standardviews/ has been deprecated. Instead; it is recommended to use the composite control available at /Cordys/WCP/Controls/runtime/bam/standardviews/instancesdashboard/ with the same name.
  • Similarly, the ProcessSelection composite control available at the location /Cordys/WCP/Controls/runtime/bam/genericviews/ has also been deprecated. Therefore, it is recommended to use the composite control available at /Cordys/WCP/Controls/runtime/bam/genericviews/processdashboard/ with the same name.


Configure a drill-down from the Instance-Level Views to drive from one view to another while making one of the content panes as the source and the other as the target.

  1. The Instance-Level Views can be reused as composite controls. In the Untitled Composite Control - Composite Control that appears, ensure that you select the composite controls from the Cordys Business Activity Monitoring folder.
  2. You can define drill-down from Instance-Level View to the Graphical view of the process. Perform the following to define the drill-down:
    1. From the project content tree, reuse the TopXInstancesByLeadTimeForStatus_SpecificProcess available at /Cordys/WCP/Controls/runtime/bam/standardviews/instancesdashboard/, ProcessInstanceGraphicalView, the ProcessInstanceActivities and the ProcessInstances composite controls. Ensure that you select the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control from the Cordys Business Activity Monitoring folder, and select the ProcessInstanceGraphicalView, ProcessInstanceActivities, ProcessInstances composite controls from the Cordys Business Process Engine folder. The respective composite controls are added to the project content tree.
    2. Drag the TopXInstancesByLeadTimeForStatus_SpecificProcess and the ProcessInstanceGraphicalView composite controls on the XForms designer.
    3. Right-click the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control on the XForms designer and select Configure Drill Down. The Message Map dialog appears.
    4. Map the output parameter Name, InstanceData > tuple > old > GetProcessLoadHistory > Name of the source to the input parameter instanceID of the target.
    5. Click OK. The Message Map dialog box closes.
    6. Click (Preview). The Preview window appears, displaying a preview of the selected XForm.
    7. In the XForm preview, click the required data point on the instance bar containing the InstanceID to retrieve the graphical view of the process. The graphical view appears, displaying the actual state of a process instance. The actual activity is highlighted to make its appearance in bold, and the execution path is displayed in a dotted line.
  3. You can define a drill-down from the Instance-Level View to the Process-Instance view. Perform the following to define the drill-down:
    1. Drag the TopXInstancesByLeadTimeForStatus_SpecificProcess and the ProcessInstanceActivities composite controls on the XForms designer. Consider the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control as the source and the ProcessInstanceActivities composite control as the target.
    2. Right-click the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control on the XForms designer and select Configure Drill Down. The Message Map dialog appears.
    3. Map the output parameter Name, that is InstanceData > tuple > old > GetProcessLoadHistory > Name of the source to the input parameter instanceID of the target.
    4. Click OK. The Message Map dialog box closes.
    5. Click (Preview). The Preview window appears. In the XForm preview, you can view details about different activities of the process instance.
  4. You can drill-down from an Instance-Level View to a Process-Instance view. Perform the following to define the drill-down:
    1. Drag the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control and the ProcessInstances composite control, which is related to the process-level view. Consider the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control as the source and the ProcessInstances composite control as the target.
    2. Right-click the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control on the XForms designer, and select Configure Drill Down. The Message Map dialog appears.
    3. Map the input parameters, ProcessName and Status of the Source to input parameters, processName and status of the Target respectively.
    4. Click OK. The Message Map dialog box closes.
    5. Click (Preview). The Preview window appears. To retrieve the process instance view, select status in an instance, and click the required data-point on the instance bar. Based on the selected instance status, the filtered view of process instances is displayed.
    6. If you are viewing the Top 'X' instances by lead-time for 'Waiting' status, then click the process instance view link. The process instance view appears, displaying the instances that have only the 'Waiting' status.
  5. You can drill-down from the ProcessSelection composite control, available at /Cordys/WCP/Controls/runtime/bam/genericviews/processdashboard/ to specific process-level views to retrieve a list of processes. Perform the following to define the drill-down:
    1. Drag the ProcessSelection and the TopXInstancesByLeadTimeForStatus_SpecificProcess composite controls on the XForms designer. Consider the ProcessSelection composite control as the source and the TopXInstancesByLeadTimeForStatus_SpecificProcess composite control as the target.
    2. Right-click the ProcessSelection composite control on the XForms designer, and select Configure Drill Down. The Message Map dialog box appears.
    3. Map the processName of the source to the input parameter ProcessName, that is InputParameters > ProcessName, of the target.
    4. Click OK. The Message Map dialog box closes.
    5. Click (Preview). The Preview window appears,
      1. Select the required process name from the Process drop-down list.
      2. Select the required timeframe and period.
      3. Click (Refresh). All the process-level views for the selected process are displayed.

Similarly, you can add the TimeFrame composite control as a run-time reference and can use it as a source. You can map the output parameters (startTime and endTime) of the TimeFrame composite control to input parameters of the target (FromDate and ToDate) or any of the composite controls related to instance-level views.

The drill-down from instance-level views are configured.

 

 

Related concepts

Standard Views

Related tasks

Configuring Drill-down from Activity-Level Views
Configuring Drill-down from Operational-Level Views
Configuring Drill-down from Process-Level Views
Configuring Drill-down from User-Level Views

Related reference

Process-Level Views
Activity-Level Views
User Level Views
Instance-Level View
Operational-Level Views